package com.apigen.platform.mapper;

import com.apigen.platform.entity.SysUser;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 系统用户 Mapper 接口
 *
 * @author API Generator
 * @since 2025-09-24
 */
@Mapper
public interface SysUserMapper extends BaseMapper<SysUser> {

    /**
     * 根据账户名查询用户
     *
     * @param accountName 账户名
     * @return 用户信息
     */
    SysUser selectByAccountName(@Param("accountName") String accountName);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户信息
     */
    SysUser selectByEmail(@Param("email") String email);

    /**
     * 根据手机号查询用户
     *
     * @param phone 手机号
     * @return 用户信息
     */
    SysUser selectByPhone(@Param("phone") String phone);

    /**
     * 分页查询用户列表
     *
     * @param page 分页参数
     * @param accountName 账户名（模糊查询）
     * @param nickName 昵称（模糊查询）
     * @param email 邮箱（模糊查询）
     * @param isEnabled 是否启用
     * @return 用户列表
     */
    IPage<SysUser> selectUserPage(Page<SysUser> page,
                                  @Param("accountName") String accountName,
                                  @Param("nickName") String nickName,
                                  @Param("email") String email,
                                  @Param("isEnabled") Boolean isEnabled);

    /**
     * 根据角色ID查询用户列表
     *
     * @param roleId 角色ID
     * @return 用户列表
     */
    List<SysUser> selectUsersByRoleId(@Param("roleId") Long roleId);

    /**
     * 更新用户最后登录信息
     *
     * @param userId 用户ID
     * @param loginIp 登录IP
     * @return 更新结果
     */
    int updateLastLoginInfo(@Param("userId") Long userId, @Param("loginIp") String loginIp);

    /**
     * 统计用户数量
     *
     * @param isEnabled 是否启用
     * @return 用户数量
     */
    int countUsers(@Param("isEnabled") Boolean isEnabled);
}
